
╔═════════╦════════════════════════════════════════════════════════════
║ GT-HELP ║ NETMAIL.BAT - the batch file that drives Netmail
╚═════════╩════════════════════════════════════════════════════════════


    The netmail batch file NETMAIL.BAT is generally executed by a QUIT
    statement in the SCHEDULE.BBS.  This works in conjunction with an
    ERRORLEVEL test in the HOST.BAT file which starts off GT in host mode.

    Usually it executes :

        MBAGGER     to bag your outgoing mail

                    Note:   it is often recommended to omit MBAGGER from
                            this run and to execute it manually after
                            reading user-entered messages, which allows you
                            to ensure that unsuitable or misplaced messages
                            do not enter the network via your system.

        MDRIVER     the main netmail program

        MDIST       to distribute any incoming mail.

        QCVT        optional, to generate Q bags from E or vice versa.

                    Note:   You only need to execute this program if you
                            have other callers collecting bags from you.
                            MDIST will happily process whatever bags it
                            receives.

    CONCOPY (by C J Dunford) is a useful program to run during the netmail
    slot, allowing you to save the screen output from the netmail session
    to look at during the day.  This example assumes you have it - just
    delete the first two parameters of affected commands if you do not.


┌───────────────────────┐
│ Constructing the file │
└───────────────────────┘

    You should always begin by setting a constant netmail drive.  This is
    the drive where the netmail system creates \mailin, \mailout and
    \mailwork. Expect general confusion and lost mail if it isn't the same
    every time.

    C:
        * establishes drive for netmail directories
        *
    DEL CONCOPY.OUT
        * deletes yesterday's saved output - or you could rename it and zip
        *   it up for later study.
        *
        *
        *                  ┌──────────────── Name of MBAGGER
        *                  │     ┌────────── Generate Q bags Only
        *                  │     │   ┌────── Keep lower case in origin line
        *               ───┴─── ─┴─ ─┘
    concopy concopy.out MBAG412 /QO /L
        *
        * Other switches to consider for MBAGGER (valid with 412):
        *
        *   /CA     Suppress both .FR and .DX requests.  As if you had both /CF and
        *               /CD on the command line at the same time.
        *   /CD     Suppress all .DX requests encountered during the bagging run.
        *   /CF     Suppress all .FR requests encountered during the bagging run.
        *
        *   /Dnn    Specifies number of days to retain echos (default nn=14)
        *
        *   /Knn    Secret encryption code for use with .CY - see ADDENDUM.NET.
        *           The 'nn' should be be a unique number between 1 and 65535.
        *
        *   /NL     No GBag Logging.
        *
        *   /OC     Use this if (and only if) you are running GT14.
        *
        *   /Q      Generates Q bags *and* E bags (E bags are larger and therefore
        *               only of interest to people who cannot use Q bags).
        *
        *   /Tm:n   Redial timing for PC-Pursuit.  See ADDENDUM.NET.
        *
        *   /VG     Lists GCONSOLE.CTL (echos you consolidate to others).
        *
        *   /Zn     Use PKZIP (rather than PKARC) to pack mailbags.  N=1 to 4
        *               determines compression level (used in PKZIP 0.9x only).
        *               Use only if recipient requests it.
        *
        * Other switches - mainly used for "supplementary" bagging runs :
        *
        *   /G      Do not bag new messages, just consolidate (generally used
        *               after MDIST /G in G_UNPAK.BAT).
        *
        *   /N      Bags up sponsored echos for the next day - but can cause
        *           a problem if you are consolidating echos.
        *
        *   /NP     No pruning - does not delete old echo bags (useful if
        *               you bag more than once a day).
        *
        *   /R:xxxx Uses an alternative routing file (default ROUTING.BBS).
        *           Note: Use the .RTG suffix if you wish use GT-HELP with it.
        *
        *   /X      Omits sponsored echos (it used to be essential if you bagged
        *               more than once a day, though these now seem to be skipped
        *               automatically if todays Q bag already exists).
        *
        *
        *                  ┌────────────────────────────── Name of Mail Driver
        *                  │         ┌──────────────────── your netmail CRC
        *                  │         │       ┌──────────── netmail start time
        *                  │         │       │    ┌─────── time to finish
        *                  │         │       │    │    ┌── latest call time
        *               ───┴──── ────┴──── ──┴─ ──┴─ ──┴─
    concopy concopy.out MDRIV047 ABCD-1234 0400 0500 0455 (cont'd...)══╗
        *                                                              ║
        * ╔════════════════════════════════════════════════════════════╝
        * ║
        * ║   ┌───────── If you support Bimodem
        * ║   │  ┌────── If you support Zmodem (ZC=DSZ.COM, or ZE=DSZ.EXE)
        * ║   │  │    ┌─ Min fallback
        * ║  ─┘ ─┴─ ──┴───
        * ╚═ /I /ZC /M2400
        *
        * Other command line switches to consider for MDRIVER (valid with 047):
        *
        *   /Bnn        Fallback limit for PC-Pursuit.  See ADDENDUM.NET.
        *
        *   /Dnn        Days before undeliverable mail becomes "stale".
        *
        *   /En         Error limit - abandon session if n errors occur.
        *
        *   /G          Execute G_UNPAK.BAT file whenever a consolidated bag rcvd
        *
        *   /H:xxxx     Names a file to be displayed to human callers.
        *
        *   /I          Allow bimodem transfers
        *
        *   /Innnn      Use bimodem only if at or below specified speed, eg 2400
        *
        *   /Ln         Limit to n attempted calls per destination.
        *
        *   /OW         Use Outbound Windows (place calls according to a schedule)
        *
        *   /P          Point nodes (xxx/9xx) can be called.  Normally, points
        *                   are expected to call you.
        *
        *   /Q          Quit when all outgoing calls have been completed
        *                   (make sure your SCHEDULE.BBS time range does not cause
        *                   the netmail batch to be re-executed).
        *
        *   /ZC         Allow Zmodem transfers, using %GTPATH%\DSZ.COM
        *
        *   /ZE         Allow Zmodem transfers, using %GTPATH%\DSZ.EXE
        *
        * Options not normally used in main NETMAIL.BAT, but may be useful
        *   in a supplementary netmail run :
        *
        *   /CA%3       Answer a crashmail call.  Only appropriate in GTCRASH.BAT.
        *
        *   /CC         Outgoing Crash Call.  Call only nodes asterisked in nodelist.
        *
        *   /R:xxxx     Uses an alternative routing file (default ROUTING.BBS).
        *               Note: Use the .RTG suffix if you wish use GT-HELP with it.
        *
        *   /NC         Crash calls to be answered but not accepted
        *   /NL         No answering - sysop local (press return to continue)
        *   /NR         No answering - sysop absent (continue session after 30 secs)
        *
        *   /NOW        Alternative to start time when making outgoing crash calls
        *
        *   /Qnnn-nnn   Process work only for node nnn/nnn.  Note the hyphen.
        *                   This only works if there is mail to go, or an OUTBOUND.
        *                   You wouldn't want to do this in your NETMAIL.BAT, but
        *                   you might use it for an outgoing crash call.
        *
        *
        *                   ┌─────────── Name of MDIST program
        *                   │     ┌───── No remote attaches
        *               ────┴─── ─┴─
    concopy concopy.out MDIST412 /NA
        *
        * Other switches to consider on MDIST command (valid with 412):
        *
        *   /Knn        Decryption code for cyphered messages.  See ADDENDUM.NET.
        *
        *   /NL         No Gbag Log.
        *
        *   /NR         .GL command lists only echos which the requester receives
        *
        *   /OC         Use this if (and only if) you are running GT14.
        *
        *   /SA         Save incoming B + G bags in MAILARC.ARC (gets huge quickly)
        *   /SB         Save incoming B bags in MAILARC.ARC
        *   /SG         Save incoming G bags in MAILARC.ARC
        *
        *   /V          Verbose listing of G bag contents in GBAG.LOG
        *
        *   /VG         Lists GCONSOLE.CTL (echos you consolidate to others).
        *
        * Other switches that might be appropriate when running MDIST after
        *   supplementary netmail sessions:
        *
        *   /G          Break down consolidated bags ONLY - do not distribute.
        *               Generally used only in G_UNPAK.BAT (executed from MDRIV)
        *
        *   /R:xxxx     Uses an alternative routing file (default ROUTING.BBS).
        *               Note: Use the .RTG suffix if you wish use GT-HELP with it.
        *
        *                  ┌─────────── Name of Q converter
        *                  │    ┌────── Create Q bags from E bags
        *              ────┴── ─┘
    concopy concpy.out QCVT105 /Q
        *
        * Optional switch /E    create E bags from Q bags (obsolescent).
        *

